home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 2.iso / dist / fw_gftp.idb / usr / freeware / share / gftp / USERS-GUIDE.z / USERS-GUIDE
Text File  |  2000-01-25  |  10KB  |  178 lines
  1. gFTP Users Guide, version 0.1 (07/06/1999)
  2. Copyright (C) 1998-1999 Brian Masney <masneyb@seul.org>
  3.  
  4.    This document is a short tutorial on how to use gFTP and describes some
  5. of its functionality. It is by far not complete at this stage, but I hope to
  6. improve on it over time. I welcome any changes or additions to this document 
  7. to make it better, and easier to read.
  8.  
  9. - Connecting to a remote site
  10.  
  11.    You can use the toolbar at the top of the window to connect to a remote
  12. site. The only mandantory field to fill in is the hostname, all of the other
  13. fields are optional. If you don't fill in the port, it will default to the ftp 
  14. port in your /etc/services file (usually port 21). If you don't fill in a 
  15. username, it will default to logging you in as anonymous. You can also open
  16. a site via a url. You can either goto Remote->Open URL, or click on the
  17. Open URL button on the toolbar. Just type in the url you want to connect to,
  18. and gftp will automatically parse it for you. You can also drag a url from
  19. netscape, and drop it on the open url button on the toolbar. If you are
  20. using a proxy server with gftp and you want to connect through it, make sure
  21. FTP->Use Proxy is turned on. 
  22.  
  23. - Using Bookmarks
  24.  
  25.    The bookmarks work about the same as they do in Netscape. If you are at a
  26. site you want to bookmark, go to Bookmarks->Add Bookmark. It will then ask
  27. you to give this bookmark a name. After you do this, it will save the
  28. settings for the current site you are connected to. If you want to pull up
  29. this site again, all you have to do is go to Bookmarks->YourDescription.
  30.    If you want to edit a bookmark, you can go to Bookmarks->Edit Bookmarks.
  31. It will pull up a tree view of your current bookmarks. You can move items
  32. around with the mouse (note: this behavior is broken in gtk+ 1.2.2, but it's
  33. fixed in 1.2.3). You can also create new folders, and new items, along with
  34. deleting items as well. If you want to edit an item, you can double click (or
  35. hit enter) on an item to pull up it's properties. You can rename, edit the 
  36. host, port, user, pass, account, and use proxy. There may be two confusing 
  37. items here: the account and the proxy option. Some older ftp servers require 
  38. the account feature, and I have had some people ask about it so I added it in. 
  39. I didn't add a account field on the toolbar because I don't think that many 
  40. people will be using it. So, that's why it only shows up here. The proxy 
  41. option here will tell gftp whether or not to connect through the proxy server. 
  42. When you load a bookmark, gftp ignores the setting of the Use Proxy under the 
  43. ftp menu...it looks at what this value is set to. This makes it nice if you 
  44. have some ftp sites behind your proxy server you want to connect to, and for 
  45. sites outside the proxy server. You won't always have to keep toggling this 
  46. setting.
  47.  
  48. - Transfering Files
  49.  
  50.    It is relatively simple to transfer files in gftp. If you want to
  51. download some files, just select what files you want to download, and hit
  52. the arrow pointing to the left. You will see the downloads appear in the
  53. download manager towards the bottom of the screen. The download may or may
  54. not start, depending on how some configuration options are set (go under
  55. FTP->Options to get the options dialog). There is an option Start File
  56. Transfers, that when set will always try to start the transfer as soon as it
  57. can. This feature is good to turn off if you are using a modem, and you have
  58. multiple sites you want to get files from. You can queue up all of the
  59. transfers, and when you are finished, just turn on start file transfers, and
  60. they will start to go. There is another option, do one transfer at a time.
  61. When this is set, it'll do what it says: only one transfer at a time. This
  62. also benefits you if you are using a modem. When you start some downloads,
  63. you can disconnect from the remote site, and connect to another one.
  64.    gFTP will only keep one control connection open to the ftp server as long
  65. as it can. When you start a file transfer, it will use the control
  66. connection gftp already had open to the ftp server. That is why you'll see
  67. cached appear at the top of the remote window. After the file transfer is
  68. complete, it'll give the control connection back to the main window as long
  69. as that's the same site you had open. If you try to change directories, or
  70. download files in the remote window while it doesn't have a control
  71. connection, it'll open up a second one to the ftp server and use that.
  72.    There is an option called Preserve permissions that some users may find
  73. useful. After you transfer a file, it will set the permissions on the file
  74. you transfered to be the same as the source.
  75.  
  76. - Transfering files with Drag and Drop
  77.  
  78.    You can drag and drop items to/from the local and remote windows. For
  79. example, you can drag some files from the local window to the remote window.
  80. This isn't too much use, but you can also drag files from midnight commander
  81. and drop them on the remote side to have the files uploaded. You can also
  82. drag ftp urls from netscape, and drop them onto the local window to
  83. automatically have them download. Note: to drag an item from gftp, you have
  84. to hold down button 3, which for a 2 button mouse is usually both buttons.
  85. If you have a 2 button mouse, you have to make sure Emulate3Buttons is
  86. enabled in the Pointer section of your XF86Config file.
  87.  
  88. - The difference between downloading files with ascii and binary
  89.  
  90.    If you download a file in binary mode, it will transfer the file as is,
  91. making no modifications to it. But, if you are transfering text files, you
  92. should transfer them as ascii (unless you're transfering it to another unix
  93. machine, which then you can use ascii or binary). In DOS, the lines in text
  94. files will have a carriage return and line feed after them. 
  95.  
  96. This is a line in a DOS text file\r\n
  97.  
  98. But, in unix the file will just be stored with a line feed at the end.
  99.  
  100. This is a line in a UNIX text file\n
  101.  
  102. If you transfer a text file from a DOS machine as binary, and open it up in
  103. vi, you will see some weird Ms at the end of each line. These are the
  104. carriage returns. To get around this, transfer the file in ascii mode, and
  105. gftp will do the proper conversion for you. You can change between ascii and
  106. binary in the ftp menu.
  107.  
  108. - The stop button
  109.  
  110.    There is a stop button on the toolbar which will let you stop gftp trying
  111. to connect to a site. Right now, the stop button is only active when it is
  112. connecting to a site, or when it is getting a directory listing. There is an
  113. option that you can disable, bring up reconnect dialog, that will suppress
  114. the dialog that comes up when you hit stop, or when you can't connect.
  115.  
  116. - When connecting to a site, make gftp auto-retry to log in again
  117.  
  118.    Sometimes you have a hard time getting into a site. Under options, you
  119. can set Connection retries to the maximum amount of times you want gftp to
  120. retry the connection. If you set this to 0, gftp will try indefinately until
  121. it gets in. There is another option Retry sleep time which tells gftp how
  122. long to wait until trying to connect to a site again. One final option is
  123. Connect timeout, which is the max amount of time gftp will allow a
  124. connection to a remote site. When this time expires, gftp will sleep the
  125. amount of seconds specified in Retry sleep time, and it will try to connect
  126. again
  127.  
  128. - Caching of Directories
  129.  
  130.    You may notice that if you have Use cache on, that when you back track to
  131. some directories you already visited, that they come up quicker, and cached
  132. appears at the top of the remote window. gFTP will save the directory
  133. listings of the directories you already visited. It will only remember the
  134. directories you visited since gftp was first started (unless it happens to
  135. crash prematurely for some reason). The current cache system does need some
  136. improvements to it, but it does help to reduce network traffic.
  137.  
  138. - Other config file options
  139.  
  140.    Most of the settings to gftp can be changed under FTP->Options, but I
  141. don't have all of the settings there yet. If you want to see all of the
  142. configurable options, edit your ~/.gftp/gftprc file. The file will be well
  143. commented, and each option will be explained. I won't go into detail here
  144. about any of them. If some of the descriptions aren't clear, please let me
  145. know and I'll try to get it cleared up there.
  146.  
  147. - Setting up your proxy server
  148.  
  149.    gFTP does support a wide range of ftp and http proxy servers. The first
  150. thing you will have to do is determine how you have to log into your proxy
  151. server. You can either change it under Options in gftp, or in your config
  152. file. The config file has much better descriptions of how each proxy type
  153. will log into the server. The ftp proxy code will be improved to handle much
  154. more servers. I'm going to make some form of generic scripting in a future
  155. version to log into the proxy server, which will simplify the proxy code, and 
  156. will provide maximum flexibility to the user.
  157.  
  158. - Setting up file extensions in the config file
  159.  
  160.    Towards the bottom of the config file, there is a section that has some
  161. ext= lines. Here you can control via a file extension, the icon in the
  162. listbox for it, the default download method (ascii or binary), and a default
  163. view/edit program. For example, let's take the line
  164.  
  165. ext=.xcf:gimp.xpm:B:gimp
  166.  
  167. The first token, .xcf, is the file extension. The next token, gimp.xpm, is
  168. the default icon to use in the listboxes. You don't have to specify one if
  169. you don't have to. By default, gftp will search ~/.gftp,
  170. $(PREFIX)/share/gftp (where prefix is your installation prefix), and then
  171. /usr/share/icons in that order. The files have to be a valid xpm file. The
  172. next token, B, specifies whether or not to download it as Binary or Ascii.
  173. If you want to have something download as Ascii, just put an A there. If you
  174. omit this field, then gftp will download the file according to whether ascii
  175. or binary is selected in the FTP menu. The final token, gimp, specifies the
  176. name of the program to run to view or edit a file with that extension. You
  177. can omit this as well if you like.
  178.